RasterCollection<T> Class

Represents a generic collection of objects.

Object Model

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

[DefaultMemberAttribute("Item")]
[SerializableAttribute()]
public class RasterCollection<T> : System.Collections.Generic.ICollection<T>, System.Collections.Generic.IEnumerable<T>, System.Collections.Generic.IList<T>, System.Collections.IEnumerable

'Declaration
 
<DefaultMemberAttribute("Item")>
<SerializableAttribute()>
Public Class RasterCollection(Of T) 
   Implements System.Collections.Generic.ICollection(Of T), System.Collections.Generic.IEnumerable(Of T), System.Collections.Generic.IList(Of T), System.Collections.IEnumerable

'Usage
 
Dim instance As RasterCollection(Of T)

public sealed class RasterCollection<T> : System.Collections.Generic.ICollection<T>, Windows.Foundation.Collections.IIterable //In WinRT the IEnumerable interface is replaced by IIterable<T>, Windows.Foundation.Collections.IVector //In WinRT the IList interface is replaced by IVector<T>, System.Collections.IEnumerable

function Leadtools.RasterCollection()

[DefaultMemberAttribute("Item")]
[SerializableAttribute()]
generic<typename T>
public ref class RasterCollection : public System.Collections.Generic.ICollection<T>, System.Collections.Generic.IEnumerable<T>, System.Collections.Generic.IList<T>, System.Collections.IEnumerable

Type Parameters

T: A generic System.Type parameter.

Remarks

The RasterCollection<T> class provides a generic collection class that implements the .NET IList, ICollection and IEnumerable interfaces.

The class contains the ItemAdded and ItemRemoved events. These events will fire whenever objects are added or removed to/from the collection.

Example

Visual Basic
C#
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Public Sub RasterCollectionExample()
   Dim rc As RasterCollection(Of String) = New RasterCollection(Of String)()
   AddHandler rc.ItemAdded, AddressOf rasterCollection_ItemAdded
   AddHandler rc.ItemRemoved, AddressOf rasterCollection_ItemRemoved

   ' add a few items
   Dim item1 As String = "item 1"
   Dim item2 As String = "item 2"
   Dim item3 As String = "item 3"

   rc.Add(item1)
   rc.Add(item2)
   rc.Add(item3)

   ' insert an item
   Dim newItem2 As String = "new item 2"
   rc.Insert(1, newItem2)

   ' check if collection contains this new item
   Debug.Assert(rc.Contains(newItem2))

   ' remove this new item
   rc.Remove(newItem2)
   Debug.Assert((Not rc.Contains(newItem2)))

   ' remove the last item
   rc.RemoveAt(rc.Count - 1)
   Debug.Assert(rc.Count = 2)

   ' send the first item to the end of the collection
   rc.SendToBack(item1, True)
   Debug.Assert(rc.IndexOf(item1) = rc.Count - 1)

   ' bring it back to the front
   rc.BringToFront(item1, True)
   Debug.Assert(rc.IndexOf(item1) = 0)

   ' copy to an array
   Dim items As String() = New String(rc.Count - 1) {}
   rc.CopyTo(items, 0)
   Debug.Assert(items.Length = rc.Count)
   Dim i As Integer = 0
   Do While i < items.Length
      Debug.Assert(items(i) = rc(i))
      i += 1
   Loop

   ' loop throw the items and show them
   For Each str As String In rc
      Console.WriteLine(str)
   Next str

   ' clean the collection
   rc.Clear()
   Debug.Assert(rc.Count = 0)
End Sub

Private Sub rasterCollection_ItemAdded(ByVal sender As System.Object, ByVal e As RasterCollectionEventArgs(Of String))
   Console.WriteLine("The Item ((" & e.Item.ToString() & ")) Has been added to the collection")
End Sub

Private Sub rasterCollection_ItemRemoved(ByVal sender As System.Object, ByVal e As RasterCollectionEventArgs(Of String))
   Console.WriteLine("The Item ((" & e.Item.ToString() & ")) Has been removed from the collection")
End Sub

public void RasterCollectionExample()
{
   RasterCollection<string> rc = new RasterCollection<string>();
   rc.ItemAdded += new EventHandler<RasterCollectionEventArgs<string>>(rasterCollection_ItemAdded);
   rc.ItemRemoved += new EventHandler<RasterCollectionEventArgs<string>>(rasterCollection_ItemRemoved);

   // add a few items
   string item1 = "item 1";
   string item2 = "item 2";
   string item3 = "item 3";

   rc.Add(item1);
   rc.Add(item2);
   rc.Add(item3);

   // insert an item
   string newItem2 = "new item 2";
   rc.Insert(1, newItem2);

   // check if collection contains this new item
   Debug.Assert(rc.Contains(newItem2));

   // remove this new item
   rc.Remove(newItem2);
   Debug.Assert(!rc.Contains(newItem2));

   // remove the last item
   rc.RemoveAt(rc.Count - 1);
   Debug.Assert(rc.Count == 2);

   // send the first item to the end of the collection
   rc.SendToBack(item1, true);
   Debug.Assert(rc.IndexOf(item1) == rc.Count - 1);

   // bring it back to the front
   rc.BringToFront(item1, true);
   Debug.Assert(rc.IndexOf(item1) == 0);

   // copy to an array
   string[] items = new string[rc.Count];
   rc.CopyTo(items, 0);
   Debug.Assert(items.Length == rc.Count);
   for(int i = 0; i < items.Length; i++)
      Debug.Assert(items[i] == rc[i]);

   // loop throw the items and show them
   foreach(string str in rc)
      Console.WriteLine(str);

   // clean the collection
   rc.Clear();
   Debug.Assert(rc.Count == 0);
}

private void rasterCollection_ItemAdded(System.Object sender, RasterCollectionEventArgs<string> e)
{
   Console.WriteLine("The Item ((" + e.Item.ToString() + ")) Has been added to the collection");
}

private void rasterCollection_ItemRemoved(System.Object sender, RasterCollectionEventArgs<string> e)
{
   Console.WriteLine("The Item ((" + e.Item.ToString() + ")) Has been removed from the collection");
}

public void RasterCollectionExample()
{
   RasterCollection<string> rc = new RasterCollection<string>();
   rc.ItemAdded += new EventHandler<RasterCollectionEventArgs<string>>(rasterCollection_ItemAdded);
   rc.ItemRemoved += new EventHandler<RasterCollectionEventArgs<string>>(rasterCollection_ItemRemoved);
   // add a few items
   string item1 = "item 1";
   string item2 = "item 2";
   string item3 = "item 3";

   rc.Add(item1);
   rc.Add(item2);
   rc.Add(item3);

   // insert an item
   string newItem2 = "new item 2";
   rc.Insert(1, newItem2);

   // check if collection contains this new item
   Debug.Assert(rc.Contains(newItem2));

   // remove this new item
   rc.Remove(newItem2);
   Debug.Assert(!rc.Contains(newItem2));

   // remove the last item
   rc.RemoveAt(rc.Count - 1);
   Debug.Assert(rc.Count == 2);

   // send the first item to the end of the collection
   rc.SendToBack(item1, true);
   Debug.Assert(rc.IndexOf(item1) == rc.Count - 1);

   // bring it back to the front
   rc.BringToFront(item1, true);
   Debug.Assert(rc.IndexOf(item1) == 0);

   // copy to an array
   string[] items = new string[rc.Count];
   rc.CopyTo(items, 0);
   Debug.Assert(items.Length == rc.Count);
   for(int i = 0; i < items.Length; i++)
      Debug.Assert(items[i] == rc[i]);

   // loop throw the items and show them
   foreach(string str in rc)
      Console.WriteLine(str);

   // clean the collection
   rc.Clear();
   Debug.Assert(rc.Count == 0);
}

private void rasterCollection_ItemAdded(System.Object sender, RasterCollectionEventArgs<string> e)
{
   Console.WriteLine("The Item ((" + e.Item.ToString() + ")) Has been added to the collection");
}

private void rasterCollection_ItemRemoved(System.Object sender, RasterCollectionEventArgs<string> e)
{
   Console.WriteLine("The Item ((" + e.Item.ToString() + ")) Has been removed from the collection");
}

Public Sub RasterCollectionExample()
   Dim rc As RasterCollection(Of String) = New RasterCollection(Of String)()
   AddHandler rc.ItemAdded, AddressOf rasterCollection_ItemAdded
   AddHandler rc.ItemRemoved, AddressOf rasterCollection_ItemRemoved
   ' add a few items
   Dim item1 As String = "item 1"
   Dim item2 As String = "item 2"
   Dim item3 As String = "item 3"

   rc.Add(item1)
   rc.Add(item2)
   rc.Add(item3)

   ' insert an item
   Dim newItem2 As String = "new item 2"
   rc.Insert(1, newItem2)

   ' check if collection contains this new item
   Debug.Assert(rc.Contains(newItem2))

   ' remove this new item
   rc.Remove(newItem2)
   Debug.Assert((Not rc.Contains(newItem2)))

   ' remove the last item
   rc.RemoveAt(rc.Count - 1)
   Debug.Assert(rc.Count = 2)

   ' send the first item to the end of the collection
   rc.SendToBack(item1, True)
   Debug.Assert(rc.IndexOf(item1) = rc.Count - 1)

   ' bring it back to the front
   rc.BringToFront(item1, True)
   Debug.Assert(rc.IndexOf(item1) = 0)

   ' copy to an array
   Dim items As String() = New String(rc.Count - 1){}
   rc.CopyTo(items, 0)
   Debug.Assert(items.Length = rc.Count)
   Dim i As Integer = 0
   Do While i < items.Length
      Debug.Assert(items(i) = rc(i))
      i += 1
   Loop

   ' loop throw the items and show them
   For Each str As String In rc
      Console.WriteLine(str)
   Next str

   ' clean the collection
   rc.Clear()
   Debug.Assert(rc.Count = 0)
End Sub

Private Sub rasterCollection_ItemAdded(ByVal sender As System.Object, ByVal e As RasterCollectionEventArgs(Of String))
   Console.WriteLine("The Item ((" & e.Item.ToString() & ")) Has been added to the collection")
End Sub

Private Sub rasterCollection_ItemRemoved(ByVal sender As System.Object, ByVal e As RasterCollectionEventArgs(Of String))
   Console.WriteLine("The Item ((" & e.Item.ToString() & ")) Has been removed from the collection")
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

RasterCollection<T> Members
Leadtools Namespace